home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d12 / vol6n10d.arc / VOL6N10.DOC < prev   
Text File  |  1987-05-17  |  11KB  |  293 lines
  1. This DOCument file (written by a user, NOT by PC-Magazine) is designed to 
  2. provide only the most basic information about the superb menu programs
  3. written by Robert L. Hummel, published in the 26 May 1987 issue of PC-
  4. Magazine (Vol. 6, No. 10), and available in the file VOL6N10.ARC.  For 
  5. detailed information and a step-by-step description of how each part of the 
  6. menu system works, please buy a copy of PC-Magazine.  
  7.  
  8. NOTE: PC-Magazine programs are COPYRIGHT material and are made available by 
  9.       PC-Magazine only for INDIVIDUAL, NONCOMMERCIAL use.  PC-Magazine 
  10.       allows copies to be made for others (including placement on 
  11.       NONCOMMERCIAL electronic bulletin boards) AS LONG AS NO CHARGE IS 
  12.       INVOLVED.  However, making copies for ANY COMMERCIAL PURPOSE IS 
  13.       STRICTLY PROHIBITED.  
  14.  
  15. This file contains
  16.  
  17.      l.  a brief description of the files in VOL6N10.ARC
  18.      2.  a brief introduction to the use of the menu system
  19.      3.  basic information about designing customized menus 
  20.          for use in the system
  21.      4.  an example of one menu, with programming comments
  22.  
  23.  
  24.  
  25. 1.  Files in VOL6N10.ARC
  26.  
  27.   DOS.BAR       ready-to-run DOS menu compiled by MAKEBAR from DOS.BDF
  28.   DOS.BDF       ASCII Bar-menu Definition File (basis of DOS.BAR)
  29.   MAKEBAR.ASM   assembler listing of MAKEBAR.COM 
  30.   MAKEBAR.BAS   BASic program that creates MAKEBAR.COM
  31.   MAKEBAR.COM   program that compiles (tokenizes) .BDF files into .BARs
  32.   SLASHBAR.ASM  assembler listing of SLASHBAR.COM
  33.   SLASHBAR.BAS  BASic program that creates SLASHBAR.COM
  34.   SLASHBAR.COM  program that loads and executes .BAR files    
  35.  
  36.  
  37. 2.  Introduction to the use of the menu system
  38.  
  39.         ASCII menuname.BDF file => MAKEBAR.COM == menuname.BAR file, then
  40.         
  41.         SLASHBAR menuname.BAR        (to make menu memory-resident), then
  42.  
  43.         hotkey (to call up mem-res menu), then ESCape (to exit menu)
  44.  
  45.  
  46.   A.  To run the DOS-menu already provided in VOL6N10.ARC, use
  47.       
  48.              SLASHBAR DOS.BAR <enter>
  49.  
  50.       This loads SLASHBAR and the DOS.BAR menu into memory.  To activate 
  51.       the menu after it's loaded, press Alt-Slash (Alt-/).  Select choices 
  52.       by moving the highlighted window or by typing the first character of 
  53.       the option chosen.  To back up through the menu levels and to exit,
  54.       use Esc.
  55.  
  56.   B.  To change the hotkey from Alt-Slash to another key combination, use 
  57.  
  58.              DEBUG SLASHBAR.COM
  59.      
  60.       -E 167 SS   (where SS is the scan code of the desired key)
  61.       -E 171 MM   (where MM is the shift mask desired-- 
  62.                   e.g., Alt=08, Ctrl=04, Left-Shift=02, Right-Shift=01)
  63.       -W
  64.       -Q
  65.  
  66.   C.  To run other menus, use
  67.  
  68.              SLASHBAR [path]menuname.ext [/n]
  69.  
  70.       where  menuname.ext     is the name of a .BAR file
  71.       and    n                is the number of bytes in the largest .BAR
  72.                                  file you intend to use before rebooting 
  73.  
  74.  
  75.       To design other menus, see next section.
  76.  
  77.  
  78. 3.  Designing customized menus
  79.  
  80.     (Specific instructions on designing customized menus are beyond the 
  81.     scope of this file.  Please see PC-Magazine for detailed information 
  82.     and explanation.) 
  83.  
  84.     SLASHBAR.COM loads, makes memory resident, and then processes menus 
  85.     in.BAR files compiled by MAKEBAR.COM from .BDF files.  The sample .BDF 
  86.     file in section 4, below, uses familiar DOS commands, but any commands 
  87.     accepted by any applications program (with a few very special 
  88.     exceptions--see PC-Magazine) can be incorporated in a .BAR menu and 
  89.     executed with just a keystroke.  
  90.  
  91.     The basic organization of a menu written in a .BDF file is
  92.  
  93.          PROGRAM "string"
  94.  
  95.          MENU name
  96.               EXECUTE name
  97.  
  98.          MENU name
  99.               OPTION name, "string"
  100.                   TYPE "string"
  101.                   ASK "string"
  102.                   INPUT
  103.                   CR
  104.          MEND
  105.          
  106.          END
  107.  
  108.       The words in CAPITAL letters are BDF commands recognized by 
  109.       MAKEBAR.COM, the compiler that processes .BDF files into .BAR files.  
  110.       A name is a single word without spaces.  A "string" is a series of 
  111.       characters surrounded by quotation marks.  
  112.  
  113.       In addition to the commands and syntax indicated above, strings in 
  114.       .BDF files can use special key names recognized by the MAKEBAR.COM 
  115.       compiler.  They are  
  116.  
  117.          {ESC}   escape                      {F1}
  118.          {TAB}                               {F2}
  119.          {ENTER}                             {F3}
  120.          {BS}    backspace                   {F4}
  121.          {HOME}                              {F5}
  122.          {PGUP}                              {F6}
  123.          {PGDN}                              {F7}
  124.          {END}                               {F8}
  125.          {U}     up arrow                    {F9}
  126.          {D}     down "                      {F10}
  127.          {L}     left "
  128.          {R}     right "
  129.          {INS}
  130.          {DEL}
  131.          {C}     control
  132.          {S}     shift
  133.          {A}     alt
  134.  
  135.       The use of this syntax is illustrated in the commented .BDF file that 
  136.       follows (the MAKEBAR compiler program ignores semicolons and 
  137.       everything following them on a line, so it's possible to comment .BDF 
  138.       files in the same way that assembler listings are commented).  
  139.  
  140.       After the .BDF file is written, it must be compiled using MAKEBAR.COM
  141.       with the following command
  142.  
  143.              MAKEBAR [path]input.bdf [path]output.bar
  144.  
  145.  
  146.  
  147.   4.  Commented examples of .BDF file
  148.  
  149.  
  150. ; Sample BDF file for some DOS commands
  151.  
  152. PROGRAM "DOS" ;each .BDF file MUST begin with PROGRAM "string"
  153.  
  154. MENU MAIN     ;1st display runs from MENU to MEND
  155.      OPTION    FILE,"FILE HANDLING FUNCTIONS" ;options are FILE DISK
  156.           EXECUTE FILE                        ;      SYSTEM and CLS,
  157.      OPTION    DISK,"DISK HANDLING FUNCTIONS" ;and "strings" appear as
  158.           EXECUTE DISK                        ;help-lines as each option
  159.      OPTION    SYSTEM,"SYSTEM MAINTENANCE"    ;is highlighted by user.
  160.           EXECUTE SYSTEM                      ;"Strings" here must be <78
  161.      OPTION    CLS,"CLEAR THE SCREEN"         ;chars. EXECUTE transfers
  162.           TYPE "CLS{ENTER}"                   ;control to another menu
  163. MEND                                          ;within same .BDF file.
  164.                                               ;Note that CLS has no
  165. MENU FILE                                     ;EXECUTE because it can be
  166.      OPTION    COPY,"COPY FILE(S)"            ;run using the TYPE command.
  167.           TYPE "COPY "                        ;Here, note the space after
  168.           ASK "ENTER SOURCE FILE(S)"          ;COPY; then user is ASKed to
  169.           INPUT                               ;INPUT the file(s) to COPY;
  170.           TYPE " "                            ;then a space is typed
  171.           ASK "COPY TO"                       ;automatically; user is asked
  172.           INPUT                               ;to INPUT destination; and a
  173.           CR                                  ;CarriageReturn completes
  174.      OPTION    DIR,"DIRECTORY OF FILES"       ;the sequence.
  175.           TYPE "DIR "
  176.           ASK "WHAT DIRECTORY (ENTER = CURRENT)"
  177.           INPUT
  178.           CR
  179.      OPTION    ERASE,"ERASE FILE(S)"
  180.           TYPE "ERASE "
  181.           ASK "ERASE WHAT FILE(S)"
  182.           INPUT
  183.           CR
  184.      OPTION    RENAME,"RENAME FILE(S)"
  185.           TYPE "REN "
  186.           ASK "ENTER OLD FILE NAME"
  187.           INPUT
  188.           TYPE " "
  189.           ASK "ENTER NEW FILE NAME"
  190.           INPUT
  191.           CR
  192.      OPTION    TYPE,"DISPLAY FILE(S)"
  193.           TYPE "TYPE "
  194.           ASK "DISPLAY WHAT FILE(S)"
  195.           INPUT
  196.           CR
  197. MEND
  198.  
  199. MENU SYSTEM
  200.      OPTION    DATE,"SET SYSTEM DATE"
  201.           TYPE "DATE "
  202.           ASK "ENTER DATE AS MM-DD-YY"
  203.           INPUT
  204.           CR
  205.      OPTION    TIME,"SET SYSTEM TIME"
  206.           TYPE "TIME "
  207.           ASK "ENTER TIME AS HH:MM:SS"
  208.           INPUT
  209.           CR
  210.      OPTION    PROMPT,"SET SYSTEM PROMPT"
  211.           TYPE "PROMPT "
  212.           ASK "ENTER NEW PROMPT"
  213.           INPUT
  214.           CR                                  ;Note difference between
  215.      OPTION    VER,"SHOW DOS VERSION"         ;CR at end of option and
  216.           TYPE "VER{ENTER}"                   ;ENTER as part of string
  217. MEND
  218.  
  219. MENU DISK
  220.      OPTION    ASSIGN,"CHANGE DRIVE ASSIGNMENT"
  221.           TYPE "ASSIGN "
  222.           ASK "WHAT DRIVE LETTER IS REFERENCED"
  223.           INPUT
  224.           TYPE "="
  225.           ASK "WHAT DRIVE SHOULD BE SUBSTITUTED"
  226.           INPUT
  227.           CR
  228.      OPTION    CHDIR,"CHANGE DIRECTORIES"
  229.           TYPE "CD "                          ;Note that menus can be
  230.           EXECUTE CHDIR                       ;nested using EXECUTE command
  231.      OPTION    FORMAT,"FORMAT A DISK"         
  232.           TYPE "FORMAT "
  233.           ASK "FORMAT WHICH DRIVE"
  234.           INPUT
  235.           CR
  236.      OPTION    LABEL,"LABEL A DISK"           ;Use of this option obviously
  237.           TYPE "LABEL "                       ;depends on DOS version used.
  238.           ASK "ENTER DRIVE TO LABEL"
  239.           INPUT
  240.           CR
  241.           ASK "ENTER NEW LABEL"
  242.           INPUT
  243.           CR
  244.      OPTION    MKDIR,"CREATE A SUBDIRECTORY"
  245.           TYPE "MD "
  246.           ASK "ENTER NAME OF SUBDIRECTORY TO CREATE"
  247.           INPUT
  248.           CR
  249.      OPTION    RMDIR,"REMOVE A SUBDIRECTORY"
  250.           TYPE "RD "
  251.           ASK "ENTER NAME OF SUBDIRECTORY TO REMOVE"
  252.           INPUT
  253.           CR
  254.      OPTION    VOL,"DISPLAY DISK VOLUME LABEL"
  255.           TYPE "VOL "
  256.           ASK "SHOW VOLUME NAME OF WHICH DRIVE"
  257.           INPUT
  258.           CR
  259. MEND
  260.  
  261. MENU CHDIR
  262.      OPTION    PARENT,"CHANGE TO PARENT DIRECTORY"
  263.           TYPE "..{ENTER}"
  264.      OPTION    ROOT,"CHANGE TO ROOT DIRECTORY"
  265.           TYPE "\{ENTER}"
  266.      OPTION    OTHER,"SPECIFY SUBDIRECTORY"
  267.           ASK "ENTER SUBDIRECTORY"
  268.           INPUT
  269.           CR
  270. MEND
  271.  
  272. END                                          ;each .BDF file must end with END
  273.  
  274. -----
  275.  
  276.  
  277. Unsolicited editorial from the author of this .DOC file:
  278.  
  279. These are examples of the outstanding programs published in every issue of 
  280. PC-Magazine.  This magazine encourages some of the most practical and 
  281. elegant programming available.  It provides detailed, clear explanations of 
  282. its programs and thereby helps readers who are not programmers to 
  283. understand how they work, how to modify them to suit their own 
  284. circumstances, and, cumulatively, how to become amateur programmers 
  285. themselves.  The magazine also allows its programs to be copied and used 
  286. FOR NONCOMMERCIAL PURPOSES (see restrictions at the beginning of this .DOC 
  287. file) and makes them available free of charge on its own bulletin board, 
  288. PC-IRS (212-696-0360).  If you like these programs, buy issues of the 
  289. magazine at newstands, or, to save a bundle, subscribe.  (I have no 
  290. connection whatsoever with the magazine except as a subscriber, and I'm not 
  291. a programmer; I've learned almost everything I know about computers and 
  292. programs from reading PC-Magazine and Peter Norton's books.)
  293.